package com.example.onlinemallsystem.service;

import com.example.onlinemallsystem.entity.Cart;
import com.example.onlinemallsystem.entity.Product;
import com.example.onlinemallsystem.entity.User;


import java.util.List;

/**
 * 购物车服务接口
 * 定义购物车相关的业务逻辑操作
 */
public interface CartService {

    /**
     * 添加商品到购物车
     * @param userId 用户ID
     * @param productId 商品ID
     * @param quantity 购买数量
     * @return 购物车项ID
     * @throws RuntimeException 商品不存在、库存不足等异常
     */
    Long addToCart(Long userId, Long productId, Integer quantity) throws RuntimeException;

    /**
     * 更新购物车商品数量
     * @param userId 用户ID
     * @param productId 商品ID
     * @param quantity 新数量
     * @return 是否更新成功
     * @throws RuntimeException 购物车项不存在等异常
     */
    boolean updateQuantity(Long userId, Long productId, Integer quantity) throws RuntimeException;

    /**
     * 切换商品选中状态
     * @param userId 用户ID
     * @param productId 商品ID
     * @param selected 是否选中(1-选中, 0-未选中)
     * @return 是否更新成功
     * @throws RuntimeException 购物车项不存在等异常
     */
    boolean updateSelected(Long userId, Long productId, Integer selected) throws RuntimeException;

    /**
     * 逻辑删除购物车商品
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 是否删除成功
     * @throws RuntimeException 购物车项不存在等异常
     */
    boolean deleteCartItem(Long userId, Long productId) throws RuntimeException;


    /**
     * 根据用户ID和商品ID查询购物车项
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 购物车项实体
     */
    Cart getCartItem(Long userId, Long productId);

    /**
     * 查询用户购物车列表
     * @param userId 用户ID
     * @return 购物车项列表（包含商品和用户信息）
     */
    List<Cart> listCartItems(Long userId);

    /**
     * 检查商品是否在购物车中
     * @param userId 用户ID
     * @param productId 商品ID
     * @return 是否存在
     */
    boolean checkProductInCart(Long userId, Long productId);

    /**
     * 计算购物车中选中商品的总价
     * @param userId 用户ID
     * @return 总价
     */
    Long calculateSelectedTotal(Long userId);
}